home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / atmconfig.z / atmconfig
Encoding:
Text File  |  2001-04-17  |  10.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaattttmmmmccccoooonnnnffffiiiigggg((((1111MMMM))))                                                    aaaattttmmmmccccoooonnnnffffiiiigggg((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      atmconfig - configure SGI OC-3c ATM port.
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----llll [ ----vvvvqqqq ] [ ----ffff _f_i_r_m_w_a_r_e ] [ ----bbbb _p_r_o_m ]
  13.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----VVVV
  14.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] { ----rrrr | ----dddd | ----uuuu }
  15.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----ssss
  16.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----TTTT _T_S_T-_s_i_z_e           ((((OOOOrrrriiiiggggiiiinnnn////OOOOnnnnyyyyxxxx2222 oooonnnnllllyyyy))))
  17.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _u_n_i_t# ] ----QQQQ _q_u_e_u_e# ,,,, _b_p_s       ((((CCCChhhhaaaalllllllleeeennnnggggeeee////OOOOnnnnyyyyxxxx oooonnnnllllyyyy))))
  18.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _u_n_i_t# ] ----RRRR _r_l__b_u_f_s ,,,, _r_l__s_i_z_e [ ,,,, _r_s__b_u_f_s ,,,, _r_s__s_i_z_e ] ]
  19.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _u_n_i_t# ] ----XXXX _x_l__b_u_f_s ,,,, _x_l__s_i_z_e [ ,,,, _x_s__b_u_f_s ,,,, _x_s__s_i_z_e ] ]
  20.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----oooo _p_h_y-_o_p_t_s
  21.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----mmmm
  22.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----aaaa
  23.      aaaattttmmmmccccoooonnnnffffiiiigggg [ ----iiii _p_o_r_t# ] ----FFFF _c_o_n_f_i_g-_f_i_l_e
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      The _a_t_m_c_o_n_f_i_g command sets and displays configuration information for SGI
  27.      OC-3c ATM ports.
  28.  
  29.      The options have the following meanings:
  30.  
  31.      ----vvvv   Verbose mode.
  32.  
  33.      ----qqqq   Quiet mode.
  34.  
  35.      ----iiii ppppoooorrrrtttt####
  36.           Specifies a particular ATM port by port number.  The default is port
  37.           0 (i.e. /hw/atm/0).
  38.  
  39.      The following options control what function aaaattttmmmmccccoooonnnnffffiiiigggg will perform.  They
  40.      have the following meanings:
  41.  
  42.      ----llll   Write the specified firmware file into the non-volatile flash EEPROM
  43.           on the specified ATM port.  There are two copies of the firmware on
  44.           any 4-Port(Origin/Onyx2) device (one for ports 0 and 1, and one for
  45.           port 2 and 3).  The write only occurs if the revision number of the
  46.           firmware installed on the interface and the firmware in the
  47.           firmware file are not equal.  Typically, this function is only used
  48.           by the ATM start-up script ////eeeettttcccc////iiiinnnniiiitttt....dddd////aaaattttmmmm....
  49.  
  50.      ----LLLL   This is the same option as ----llll but the firmware is rewritten
  51.           regardless of the version number present on the port.
  52.  
  53.      ----rrrr   sends a hardware reset to one of the two on-board processors on the
  54.           4-port interface in the Origin/Onyx2.  This forces the port and the
  55.           port adjacent to it( _p_o_r_t#+_1 if the specified port # is even,
  56.           otherwise _p_o_r_t#-_1 ) into the pppprrrreeee----iiiinnnniiiitttt state.  On the Challenge/Onyx
  57.           platforms the specified port is forced to the pppprrrreeee----iiiinnnniiiitttt state via a
  58.           hardware reset.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaattttmmmmccccoooonnnnffffiiiigggg((((1111MMMM))))                                                    aaaattttmmmmccccoooonnnnffffiiiigggg((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----dddd   puts the port in the ddddoooowwwwnnnn state.  This can be done from either the
  75.           uuuupppp (Challenge/Onyx only) or pppprrrreeee----iiiinnnniiiitttt states.  It is in this state
  76.           that the transmit schedule table can be adjusted.  This command will
  77.           fail if any application programs still have file descriptors open
  78.           from the previous time the port was operational.
  79.  
  80.      ----uuuu   puts the port in the uuuupppp state.
  81.  
  82.      ----VVVV   This option shows the version number of the firmware installed on
  83.           the port.
  84.  
  85.      ----ssss   This option shows the buffer configuration, TST configuration
  86.           (Origin/Onyx2), and state of the port.  If the state is pppprrrreeee----iiiinnnniiiitttt,,,,
  87.           the configuration will not be displayed.
  88.  
  89.      ----QQQQ nnnn,,,,bbbbppppssss
  90.           Set rate queue _n to _b_p_s bits per second.  This can fail if any
  91.           application has virtual circuits using the rate queue.
  92.           (Challenge/Onyx only)
  93.  
  94.      ----RRRR rrrrllll____bbbbuuuuffffssss,,,,rrrrllll____ssssiiiizzzzeeee[[[[,,,,rrrrssss____bbbbuuuuffffssss,,,,rrrrssss____ssssiiiizzzzeeee]]]]]]]]
  95.           Alter the configuration of receive buffers.  This can only be done
  96.           when the interface is in the ddddoooowwwwnnnn state.
  97.  
  98.      ----XXXX xxxxllll____bbbbuuuuffffssss,,,,xxxxllll____ssssiiiizzzzeeee[[[[,,,,xxxxssss____bbbbuuuuffffssss,,,,xxxxssss____ssssiiiizzzzeeee]]]]]]]]
  99.           Alter the configuration of transmit buffers.  This can only be done
  100.           when the interface is in the ddddoooowwwwnnnn state.
  101.  
  102.      ----oooo pppphhhhyyyy----oooopppptttt----bbbbiiiittttssss
  103.           Sets the PHY option bits for the OC3c port.  Bit 0 controls the
  104.           SONET loop-timing feature.  When bit 0 is set with aaaattttmmmmccccoooonnnnffffiiiigggg ----oooo 1111
  105.           the SONET transmit clock is derived from the clock captured from the
  106.           SONET receiver (this is the default).  This is the appropriate
  107.           setting when the ATM port is connected to a switch.  When bit 0 is
  108.           cleared with aaaattttmmmmccccoooonnnnffffiiiigggg ----oooo 0000 the SONET transmit clock is derived from
  109.           a clock on the ATM-OC3c device.  This configuration allows two OC-3c
  110.           ports to function when connected directly to each other without an
  111.           ATM switch.  Other values used with the ----oooo option are reserved for
  112.           diagnostic functions.
  113.  
  114.      ----mmmm   Show the permanent MAC address assigned to this port.
  115.  
  116.      ----aaaa   Show the ATM address assigned to this port.
  117.  
  118.      ----TTTT TTTTSSSSTTTT----ssssiiiizzzzeeee
  119.           Adjust the size of the transmit schedule table. (Origin/Onyx2 only)
  120.  
  121.      ----FFFF ccccoooonnnnffffiiiigggg----ffffiiiilllleeee
  122.           Read a file containing configuration parameters and set the port
  123.           parameters appropriately.  Currently, the transmit schedule table
  124.           (TST) size and the PHY options are the only parameters that can be
  125.           put in the config file.  This option is used by the initialization
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaattttmmmmccccoooonnnnffffiiiigggg((((1111MMMM))))                                                    aaaattttmmmmccccoooonnnnffffiiiigggg((((1111MMMM))))
  137.  
  138.  
  139.  
  140.           script, ////eeeettttcccc////iiiinnnniiiitttt....dddd////aaaattttmmmm,,,, to set the TST size and PHY option bits at
  141.           system boot time using ////vvvvaaaarrrr////aaaattttmmmm////aaaattttmmmmhhhhwwww....ccccoooonnnnffff as the configuration
  142.           file.
  143.  
  144. NNNNOOOOTTTTEEEE
  145.      After software upgrades, the system start-up scripts will update the
  146.      flash EEPROM automatically via aaaattttmmmmccccoooonnnnffffiiiigggg.... Under normal circumstances, the
  147.      firmware should never need to be manually updated by an administrator.
  148.  
  149.      Under normal conditions, aaaattttmmmmccccoooonnnnffffiiiigggg should not be used to shut down and
  150.      bring up ATM ports.  The initialization file ////eeeettttcccc////iiiinnnniiiitttt....dddd////aaaattttmmmm does a
  151.      better job of starting and stopping the entire ATM subsystem.
  152.  
  153. FFFFIIIILLLLEEEESSSS
  154.      /usr/lib/atm/atmlincfw (ATM XIO 4-Port OC-3c firmware - Origin/Onyx2)
  155.      /usr/lib/atm/lincprom (ATM XIO 4-Port OC-3c prom - Origin/Onyx2)
  156.      /usr/lib/atm/atm_firm.o (ATM HIO OC-3c firmware - Challenge/Onyx)
  157.      /usr/lib/atm/flash.o (ATM HIO OC-3c prom - Challenge/Onyx)
  158.      /var/atm/atmhw.conf
  159.  
  160. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  161.      atm(7M), atmstat(1M), atmtest(1M)
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.